package com.example.chamberlainserver.Service;

import com.example.chamberlainserver.Entry.Counselor;
import com.example.chamberlainserver.dto.CounselorDTO;
import com.example.chamberlainserver.dto.PageResult;

import java.util.List;

/**
 * 辅导员服务接口
 */
public interface CounselorService {
 
    /**
     * 查询所有辅导员
     * @return 辅导员列表
     */
    List<Counselor> getAllCounselors();

    /**
     * 根据ID查询辅导员
     * @param id 辅导员ID
     * @return 辅导员信息
     */
    Counselor getCounselorById(Long id);

    /**
     * 根据工号查询辅导员
     * @param employeeId 工号
     * @return 辅导员信息
     */
    Counselor getCounselorByEmployeeId(String employeeId);

    /**
     * 分页查询辅导员
     * @param page 页码
     * @param size 每页大小
     * @param name 姓名（可选）
     * @param department 部门（可选）
     * @param status 状态（可选）
     * @return 分页结果
     */
    PageResult<Counselor> getCounselorsByPage(int page, int size, String name, String department, Integer status);

    /**
     * 创建辅导员
     * @param counselorDTO 辅导员信息
     * @return 创建的辅导员
     */
    Counselor createCounselor(CounselorDTO counselorDTO);

    /**
     * 更新辅导员信息
     * @param id 辅导员ID
     * @param counselorDTO 更新的辅导员信息
     * @return 更新后的辅导员
     */
    Counselor updateCounselor(Long id, CounselorDTO counselorDTO);

    /**
     * 删除辅导员
     * @param id 辅导员ID
     * @return 是否删除成功
     */
    boolean deleteCounselor(Long id);

    /**
     * 批量删除辅导员
     * @param ids 辅导员ID列表
     * @return 删除成功的数量
     */
    int deleteCounselors(List<Long> ids);

    /**
     * 根据班级ID查询辅导员
     * @param classId 班级ID
     * @return 辅导员列表
     */
    List<Counselor> getCounselorsByClassId(Long classId);

    /**
     * 查询未分配班级的辅导员
     * @return 辅导员列表
     */
    List<Counselor> getUnassignedCounselors();

    /**
     * 更新辅导员状态
     * @param id 辅导员ID
     * @param status 状态
     * @return 是否更新成功
     */
    boolean updateCounselorStatus(Long id, Integer status);

    /**
     * 更新辅导员权限
     * @param id 辅导员ID
     * @param permissions 权限
     * @return 是否更新成功
     */
    boolean updateCounselorPermissions(Long id, String permissions);

    /**
     * 验证工号是否唯一
     * @param employeeId 工号
     * @param excludeId 排除的ID（用于更新时验证）
     * @return 是否唯一
     */
    boolean isEmployeeIdUnique(String employeeId, Long excludeId);

    /**
     * 验证邮箱是否唯一
     * @param email 邮箱
     * @param excludeId 排除的ID（用于更新时验证）
     * @return 是否唯一
     */
    boolean isEmailUnique(String email, Long excludeId);

    /**
     * 验证手机号是否唯一
     * @param phone 手机号
     * @param excludeId 排除的ID（用于更新时验证）
     * @return 是否唯一
     */
    boolean isPhoneUnique(String phone, Long excludeId);
}